QuickTime 4 API Documentation

3D Graphics Programming with QuickDraw 3D 1.5.4

Previous | QD3D Book | Overview | Chapter Contents | Next |

Managing Orthographic Cameras

QuickDraw 3D provides routines that you can use to create and edit orthographic cameras.

Q3OrthographicCamera_New

You can use the Q3OrthographicCamera_New function to create a new orthographic camera.

TQ3CameraObject Q3OrthographicCamera_New (
                     const TQ3OrthographicCameraData *orthographicData);
orthographicData
A pointer to an orthographic camera data structure.

DESCRIPTION

The Q3OrthographicCamera_New function returns, as its function result, a new orthographic camera having the camera characteristics specified by the orthographicData parameter.

Q3OrthographicCamera_GetData

You can use the Q3OrthographicCamera_GetData function to get the data that defines an orthographic camera.

TQ3Status Q3OrthographicCamera_GetData (
                     TQ3CameraObject camera,
                     TQ3OrthographicCameraData *cameraData);
camera
An orthographic camera object.
cameraData
On exit, a pointer to an orthographic camera data structure.

DESCRIPTION

The Q3OrthographicCamera_GetData function returns, through the cameraData parameter, information about the orthographic camera specified by the camera parameter. See "Orthographic Camera Data Structure" for the structure of an orthographic camera data structure.

Q3OrthographicCamera_SetData

You can use the Q3OrthographicCamera_SetData function to set the data that defines an orthographic camera.

TQ3Status Q3OrthographicCamera_SetData (
                                         TQ3CameraObject camera,
                                         const TQ3OrthographicCameraData *cameraData);
camera
An orthographic camera object.
cameraData
A pointer to an orthographic camera data structure.

DESCRIPTION

The Q3OrthographicCamera_SetData function sets the data associated with the orthographic camera specified by the camera parameter to the data specified by the cameraData parameter.

Q3OrthographicCamera_GetLeft

You can use the Q3OrthographicCamera_GetLeft function to get the left side of an orthographic camera.

TQ3Status Q3OrthographicCamera_GetLeft (
                     TQ3CameraObject camera,
                     float *left);
camera
An orthographic camera object.
left
On exit, the left side of the specified orthographic camera.

DESCRIPTION

The Q3OrthographicCamera_GetLeft function returns, in the left parameter, a value that specifies the left side of the orthographic camera specified by the camera parameter.

Q3OrthographicCamera_SetLeft

You can use the Q3OrthographicCamera_SetLeft function to set the left side of an orthographic camera.

TQ3Status Q3OrthographicCamera_SetLeft (
                     TQ3CameraObject camera,
                     float left);
camera
An orthographic camera object.
left
The desired left side of the specified orthographic camera.

DESCRIPTION

The Q3OrthographicCamera_SetLeft function sets the left side of the orthographic camera specified by the camera parameter to the value specified by the left parameter.

Q3OrthographicCamera_GetTop

You can use the Q3OrthographicCamera_GetTop function to get the top side of an orthographic camera.

TQ3Status Q3OrthographicCamera_GetTop (
                     TQ3CameraObject camera,
                     float *top);
camera
An orthographic camera object.
top
On exit, the top side of the specified orthographic camera.

DESCRIPTION

The Q3OrthographicCamera_GetTop function returns, in the top parameter, a value that specifies the top side of the orthographic camera specified by the camera parameter.

Q3OrthographicCamera_SetTop

You can use the Q3OrthographicCamera_SetTop function to set the top side of an orthographic camera.

TQ3Status Q3OrthographicCamera_SetTop (
                     TQ3CameraObject camera,
                     float top);
camera
An orthographic camera object.
top
The desired top side of the specified orthographic camera.

DESCRIPTION

The Q3OrthographicCamera_SetTop function sets the top side of the orthographic camera specified by the camera parameter to the value specified by the top parameter.

Q3OrthographicCamera_GetRight

You can use the Q3OrthographicCamera_GetRight function to get the right side of an orthographic camera.

TQ3Status Q3OrthographicCamera_GetRight (
                     TQ3CameraObject camera,
                     float *right);
camera
An orthographic camera object.
right
On exit, the right side of the specified orthographic camera.

DESCRIPTION

The Q3OrthographicCamera_GetRight function returns, in the right parameter, a value that specifies the right side of the orthographic camera specified by the camera parameter.

Q3OrthographicCamera_SetRight

You can use the Q3OrthographicCamera_SetRight function to set the right side of an orthographic camera.

TQ3Status Q3OrthographicCamera_SetRight (
                     TQ3CameraObject camera,
                     float right);
camera
An orthographic camera object.
right
The desired right side of the specified orthographic camera.

DESCRIPTION

The Q3OrthographicCamera_SetRight function sets the right side of the orthographic camera specified by the camera parameter to the value specified by the right parameter.

Q3OrthographicCamera_GetBottom

You can use the Q3OrthographicCamera_GetBottom function to get the bottom side of an orthographic camera.

TQ3Status Q3OrthographicCamera_GetBottom (
                     TQ3CameraObject camera,
                     float *bottom);
camera
An orthographic camera object.
bottom
On exit, the bottom side of the specified orthographic camera.

DESCRIPTION

The Q3OrthographicCamera_GetBottom function returns, in the bottom parameter, a value that specifies the bottom side of the orthographic camera specified by the camera parameter.

Q3OrthographicCamera_SetBottom

You can use the Q3OrthographicCamera_SetBottom function to set the bottom side of an orthographic camera.

TQ3Status Q3OrthographicCamera_SetBottom (
                     TQ3CameraObject camera,
                     float bottom);
camera
An orthographic camera object.
bottom
The desired bottom side of the specified orthographic camera.

DESCRIPTION

The Q3OrthographicCamera_SetBottom function sets the bottom side of the orthographic camera specified by the camera parameter to the value specified by the bottom parameter.


© 1997 Apple Computer, Inc.

Previous | QD3D Book | Overview | Chapter Contents | Next |